home *** CD-ROM | disk | FTP | other *** search
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- NNNNAAAAMMMMEEEE
- glp, printpanel - graphical lp printing command
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ggggllllpppp [ X toolkitoption... ] [----cccc] [----dddddest] [----mmmm]
- [----nnnnnumber] [----oooooption] [----ssss] [----tttttitle] [----wwww]
- [----EEEE] [----FFFF] [----NNNN] [files]
- PPPPrrrriiiinnnnttttPPPPaaaannnneeeellll and pppprrrriiiinnnnttttppppaaaannnneeeellll are aliases for ggggllllpppp
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- _g_l_p, also known as _P_r_i_n_t_P_a_n_e_l and _p_r_i_n_t_p_a_n_e_l, provides a graphical
- interface to the _l_p(_1) printing command of the AT&T System V print
- spooling system. The _g_l_p program accepts all _l_p command line options and
- allows these options to be set interactively.
-
- Similar to _l_p, _g_l_p permits multiple filenames to be specified on the
- command line for printing. _g_l_p also permits its standard input to be
- redirected so that the output of other programs can be printed using
- redirection or piping. In addition, if _g_l_p is invoked without any
- filenames specified and without a standard input redirection or pipe,
- files for printing may be specified interactively on the _g_l_p panel.
-
- CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
- The _g_l_p program supports all of the command line switches of the System V
- _l_p command. An explanation of these switches is reproduced here for user
- convenience. For more information refer to the _l_p(_1) man page. The _g_l_p
- program supports additional command line switches to tailor print job
- parameters and program display. The setting of options on the _g_l_p
- command line will be reflected on the program's control panel graphical
- display. As with the _l_p command, command line options that take arguments
- must not have any whitespace between the option and its argument.
- Further, due to possible conflicts between options relevant to the X
- toolkit and options relevant to _g_l_p, all X toolkit options should be
- specified using the full option name. For example, the X toolkit title
- option should be specified as ----ttttiiiittttlllleeee.
-
- The following System V _l_p command lines switches are supported:
-
- ----cccc Make copies in the spooling directory of the file(s) to be
- printed. Normally, files will not be copied, but will be linked
- whenever possible. If the ----cccc option is not given, then the user
- should be careful not to remove any of the files before the
- printing of the files has been completed. Also if the ----cccc option
- has not been given, any changes to the files to be printed will
- be reflected in the printed output.
-
- ----dddd_d_e_s_t Specifies the printer or printer class that is to perform the
- printing. _d_e_s_t specifies the printer name or printer class
- name. If the ----dddd option is not specified then the printer
- selected will be the value of the LLLLPPPPDDDDEEEESSSSTTTT environment variable.
- If LLLLPPPPDDDDEEEESSSSTTTT is not set, the system default printer will be
- selected. If there is no system default printer, a list of all
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- printers known to the system is sorted alphabetically and the
- first printer on the list will be used.
-
- ----mmmm Specifies that a mail message should be sent after the file(s)
- have been printed. By default no mail is sent upon normal
- completion of the print request.
-
- ----nnnn_n_u_m_b_e_r Specifies that _n_u_m_b_e_r of copies of the file(s) should be
- printed.
-
- ----oooo_o_p_t_i_o_n Specifies a printer specific or printer class specific option
- given by the string _o_p_t_i_o_n. Several _o_p_t_i_o_n strings may be
- specified on the command line by using the ----oooo switch more than
- once. The easiest method for setting printer specific options
- is to use the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button in the action area or the
- MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ item on the FFFFiiiilllleeee menu. If an option panel is
- not available for a selected printer you must review the
- printer interface script located in
- /_v_a_r/_s_p_o_o_l/_l_p/_i_n_t_e_r_f_a_c_e/[_p_r_i_n_t_e_r _n_a_m_e] to obtain the complete
- list of options for that printer. Typically, a printer will
- accept the option "h" or "nobanner" to prevent the printing of
- a banner page.
-
- ----ssss When a print job is submitted to the spooling system the job ID
- is either displayed in a dialog box (graphical mode) or is
- printed to standard output (non-graphical mode). If the ----ssss
- option is specified, no job ID message is shown.
-
- ----tttt_t_i_t_l_e Specifies a title for the print job banner page.
-
- ----wwww Specifies that a message should be printed on the system
- console after the files have been printed. If the user is not
- logged in, a mail message will be sent.
-
- The following command line switches are specific to _g_l_p:
-
- ----FFFF Normally, _g_l_p checks whether its standard input is coming from
- a terminal or from a file. If _g_l_p is getting its standard input
- from a file (i.e. the contents of a file have been piped or
- redirected into _g_l_p), the program does not display the filename
- entry area. Sometimes _g_l_p will not have its standard input
- coming from a terminal but the filename entry area should be
- displayed. This is the case when _g_l_p is invoked from the
- Toolchest. The ----FFFF switch forces the display of the filename
- entry area regardless of the state of the standard input. When
- ----FFFF is specified _g_l_p will take its input only from the filename
- entry area even if a pipe or redirection has been specified on
- the command line. The ----FFFF switch should be used when invoking
- _g_l_p from the Toolchest, a Workspace FTR rule, or from any
- program that will not associate a terminal with _g_l_p'_s standard
- input.
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- ----NNNN Runs the _g_l_p program in non-graphical mode. In this mode no
- control panel is displayed and the program acts like the
- standard System V _l_p command.
-
- CCCCoooonnnnttttrrrroooollll PPPPaaaannnneeeellll UUUUssssaaaaggggeeee
- The _g_l_p program presents a control panel that consists of up to five main
- areas. These areas are the menu bar, filename entry area, printer
- selection area, job option area and the action area. These areas are
- described below.
-
- MMMMeeeennnnuuuu bbbbaaaarrrr The application menu bar, located at the top of the _g_l_p panel,
- provides access to all application functions. Commonly used
- functions such as printing and option handling are also
- accessible from buttons in the action area as described below.
- The menu bar contains the following items:
-
- FFFFiiiilllleeee
-
- PPPPrrrriiiinnnntttt Submits the specified file(s) or standard input
- data for printing by the spooling system. In
- graphical mode a dialog will either confirm the
- submittal of the print job or display an error
- message. In non-graphical mode the print job ID
- will be sent to the standard output (unless the
- ----ssss command line switch has been specified or the
- nnnnooooJJJJoooobbbbIIIIdddd resource has been set to TTTTrrrruuuueeee). If no
- errors have occurred submitting the print job to
- the spooling system, the job submittal dialog
- box will provide one or two buttons. If the
- print job is submitted normally, both an _O_K and
- an _E_x_i_t button will be displayed. The _O_K button
- will dismiss the dialog and the _E_x_i_t button will
- exit the _g_l_p program. If the job was submitted
- from the standard input, only an _E_x_i_t button
- will be displayed.
-
- OOOOppppeeeennnn............ Selecting this menu item will bring up a file
- selection dialog box. The file selected from the
- dialog will be displayed in the filename entry
- area. Note that the previous contents of the
- filename entry area will be replaced by the
- filename selected from the selection dialog.
-
- MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
- Many printers provide specialized, vendor-
- specific options. The job option area provides a
- text type-in field for specifying these printer
- specific options. However, some printers provide
- a graphical dialog for specifying the printer
- specific options. If such a dialog is available
- for the selected printer, the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
- menu item will have a normal appearance. If no
-
-
-
- PPPPaaaaggggeeee 3333
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- dialog is available, the item will appear grayed
- out.
-
- When the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ item is selected, the
- graphical options dialog for the selected
- printer will be displayed. At the same time, the
- printer specific options type-in field in the
- job option area will be grayed out. When the
- desired options have been selected on the option
- dialog, the OOOOKKKK button on the dialog should be
- pressed. This will remove the dialog from the
- screen and will place text in the printer
- specific options field in the job option area.
- This text represents the options selected on the
- graphical option dialog. An AAAAppppppppllllyyyy button is
- also available for specifying options without
- dismissing the dialog. Note that the type in
- field in the job option area becomes ungrayed
- and editable when the option dialog is no longer
- displayed.
-
- SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............
- Brings up a dialog that allows spooler and
- printer specific option settings to be saved to
- disk. The spooler option settings are written to
- the file ~/._g_l_p_r_c. Spooler options consist of
- all settings in the job option area except the
- printer specific options type-in values and the
- number of copies. If printer specific options
- have been modified for any listed printer, those
- printers are listed on the dialog. These options
- are stored on a per printer basis in files named
- /_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r
- _n_a_m_e>/<_u_s_e_r_n_a_m_e>. Note that the number of copies
- is not saved to either file since this option is
- more appropriately specified on the command line
- or via the job option are control. Printer
- specific options cannot be saved for printer
- classes. If _g_l_p is run by either the user _r_o_o_t
- or _l_p, the Save dialog permits the saving of
- printer specific options for all users of the
- selected printer.
-
- QQQQuuuuiiiitttt Removes the _g_l_p panel from the screen and
- terminates the program. Selecting this item
- does not cancel any currently pending print
- jobs.
-
- OOOOtttthhhheeeerrrr TTTToooooooollllssss
-
-
-
-
-
-
- PPPPaaaaggggeeee 4444
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- PPPPrrrriiiinnnnttttSSSSttttaaaattttuuuussss
- Selecting this menu item runs the _P_r_i_n_t_S_t_a_t_u_s
- program for the currently selected printer.
-
- HHHHeeeellllpppp
-
- GGGGeeeennnneeeerrrraaaallll HHHHeeeellllpppp
- Presents a dialog containing help information
- for the _g_l_p program.
-
- FFFFiiiilllleeeennnnaaaammmmeeee eeeennnnttttrrrryyyy aaaarrrreeeeaaaa
- This area, located in the upper left portion of the _g_l_p panel,
- provides a text entry field in which the names of files to be
- printed can be entered. Multiple filenames may be specified
- with each filename separated by whitespace. Bourne shell
- filename meta characters such as '*' may be specified but job
- control meta characters such as ';' are not permitted. If
- filenames were specified on the _g_l_p command line, these
- filenames will appear in the filename entry area when the panel
- first appears on the screen. If the _g_l_p program standard input
- has been redirected or piped from another programs output, the
- filename entry area will not be displayed and all data to be
- printed will come from the standard input.
-
- PPPPrrrriiiinnnntttteeeerrrr sssseeeelllleeeeccccttttiiiioooonnnn aaaarrrreeeeaaaa
- The left portion of the _g_l_p panel contains the printer
- selection area. This area displays a list of the printers
- available to the print spooling system. Any printer from the
- list may be selected for printing. If a printer was specified
- on the command line using the ----dddd option, the program will come
- up with this printer selected on the list (assuming the printer
- has been installed on the system). If a printer is not
- specified on the command line, the system default printer will
- be selected. Finally, if there is no system default printer,
- the first printer on the list is selected.
-
- If a system default printer exists, it will be displayed in
- bold text on the printer list.
-
- Printer status information can be obtained by double-clicking
- on a printer on the list. This will bring up the _P_r_i_n_t_S_t_a_t_u_s
- tool for the selected printer.
-
- JJJJoooobbbb ooooppppttttiiiioooonnnn aaaarrrreeeeaaaa
- This area on the right side of the program panel provides
- controls for various print job options. Mostly these controls
- duplicate the command line options of the _g_l_p and _l_p programs.
- If print job options were specified on the _g_l_p command line,
- they will be reflected in the initial setting of the
- corresponding control in the job option area. Any option
- settings specified in the ~/._g_l_p_r_c file will also be reflected
- in the initial settings of the option controls with the
-
-
-
- PPPPaaaaggggeeee 5555
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- exception of the number of copies.
-
- AAAAccccttttiiiioooonnnn aaaarrrreeeeaaaa
- The action area is located at the bottom of the program panel
- and contains the push buttons for commonly used program
- operations. The functions performed by these buttons can also
- be accomplished using the items in the menu bar. The action
- area buttons have the following functions:
-
- PPPPrrrriiiinnnntttt Submits the specified file(s) or standard input data
- for printing by the spooling system. See the above
- explanation of the PPPPrrrriiiinnnntttt menu item for detailed
- information about this button.
-
- MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
- Displays the printer specific options panel for the
- selected printer. See the above explanation of the
- MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ menu item for detailed information
- about this button.
-
- SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............
- Brings up a dialog that allows spooler and printer
- specific option settings to be saved to disk. See the
- above explanation of the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ menu item
- for detailed information about this button.
-
- SSSSeeeettttttttiiiinnnnggggssss FFFFiiiilllleeeessss
- On startup the _g_l_p program will read the file ._g_l_p_r_c if it exists in the
- user's home directory. This file is expected to contain a single line of
- option switches for the _g_l_p program. The switches are the same as those
- available on the command line except that the ----dddd, ----oooo, ----nnnn and ----NNNN options
- must not be specified. Note that command line switches take the highest
- precedence followed by the ._g_l_p_r_c file settings followed by the X
- resource settings.
-
- On startup the _g_l_p program also looks for files named
- /_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r _n_a_m_e>/<_u_s_e_r_n_a_m_e> for each printer on the
- available printer list. For each printer, if the <_u_s_e_r_n_a_m_e> file is not
- found a file name _d_e_f_a_u_l_t_S_e_t_t_i_n_g_s will be read, if it exists. The file
- is expected to contain a single line of printer specific options. The
- options are listed as they would be typed into the printer specific
- options type-in field in the job options area. Any additional lines in
- the file will be ignored. Any printer specific options specified on the
- command line will be appended to the options found in the settings file
- for the initially selected printer. Note that printer specific options
- are maintained on a per printer, per user basis. When a new printer is
- selected from the list of available printers, any options specified for
- that printer will be displayed in the job option area.
-
- Spooler and printer specific options can be saved using either the SSSSaaaavvvveeee
- OOOOppppttttiiiioooonnnnssss............ button in the action area or the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ item on the
- FFFFiiiilllleeee menu.
-
-
-
- PPPPaaaaggggeeee 6666
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- WWWWiiiiddddggggeeeetttt HHHHiiiieeeerrrraaaarrrrcccchhhhyyyy
- The following is an abbreviated widget hierarchy for _g_l_p.
-
- glp (Glp)
- menuBar (XmRowColumn)
- printBox (PuiPrintBox)
-
- The _g_l_p program is actually a wrapper around the PPPPrrrriiiinnnnttttBBBBooooxxxx widget
- contained in the _l_i_b_p_r_i_n_t_u_i library. For detailed information on the
- PrintBox and its resources refer to the man pages for _l_i_b_p_r_i_n_t_u_i(_3_X) and
- _P_u_i_P_r_i_n_t_B_o_x(_3_X).
-
- PPPPRRRROOOOGGGGRRRRAAAAMMMM RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
- _g_l_p is written using the standard X toolkit and the Motif widget set. The
- program accepts all standard Xt/Motif resources and command line options.
- In addition to these resources the following resources are specific to
- the _g_l_p program and may be specified by the user.
-
- pppprrrriiiinnnntttteeeerrrrPPPPrrrrooooggggrrrraaaammmm (class PPPPrrrriiiinnnntttteeeerrrrPPPPrrrrooooggggrrrraaaammmm)
- Specifies the full pathname of the program to be executed
- when a printer on the available printer list is double-
- clicked. The program will be passed the name of the
- currently selected printer as an argument. If no program
- is to be executed this resource should be specified with
- no value (i.e. "Glp*printerProgram:"). By default the
- _P_r_i_n_t_S_t_a_t_u_s program is executed.
-
- nnnnooooJJJJoooobbbbIIIIdddd (class NNNNooooJJJJoooobbbbIIIIdddd)
- Specifies whether the print job ID should be displayed
- when a print job is successfully submitted to the spooling
- system. If this resource is set to TTTTrrrruuuueeee (default), the job
- ID will be displayed. If the resource is set to FFFFaaaallllsssseeee the
- job ID will not be shown. If _g_l_p is in graphical mode, the
- job ID will be displayed in a dialog box. If the program
- is in non-graphical mode, the job ID will be printed on
- the standard output.
-
- NNNNOOOOTTTTEEEESSSS
- 1. The _g_l_p program submits print job to the AT&T System V print
- spooler. The BSD spooling system is not currently supported.
-
- 2. The ----EEEE command line switch is no longer needed. The _g_l_p program will
- silently ignore this switch.
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- lp(1), PrintStatus(1), libprintui(3X), PuiPrintBox(3X)
-
- FFFFIIIILLLLEEEESSSS
- /usr/lib/X11/app-defaults/Glp Program resource file
- $HOME/.glprc Generic option file
-
-
-
-
-
- PPPPaaaaggggeeee 7777
-
-
-
-
-
-
- GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
-
-
-
- /var/spool/lp/settings/<printer name>/<username>
- Per printer, per user printer specific
- option files
- /var/spool/lp/settings/<printer name>/defaultSettings
- Per printer default printer specific
- options
- /var/spool/lp/gui_model Printer specific graphical option
- dialogs
- /var/spool/lp Directory for System V spooling system
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 8888
-
-
-
-